home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / tribbs / klpak12.zip / SYSCHAT.DOC < prev    next >
Text File  |  1996-02-26  |  7KB  |  139 lines
  1. SYSCHAT is the shining star of this utility package.  It is a replacement
  2. for TriBBS's internal page AND chat routines.  It is extremely configurable.
  3. SYSCHAT requires that the user have an ANSI capable terminal though.
  4.  
  5.  
  6. Command line parameters:
  7.  
  8.  
  9.         USAGE:     SYSCHAT cfg.cfg [IRQ] [/P:] [/C:] [/flow] [/host:]
  10.  
  11.         Where:
  12.  
  13.         cfg.cfg          is the name of your configuration file.
  14.  
  15.         IRQ              (optional), if you are using a NON-STANDARD IRQ 
  16.                          specify the IRQ number, ONLY if you are using a 
  17.                          NON-STANDARD IRQ.
  18.  
  19.         /P:nn:nn,xx:xx   (optional), turns paging hours ON between nn:nn and 
  20.                          xx:xx. 
  21.                          
  22.                          IMPORTANT, for this to function to work properly you 
  23.                          must specify the time in 24hr. format.
  24.  
  25.         /C:aa,bb,cc,dd   (optional), Sets the colors for the text windows, 
  26.                          where aa,bb is the USER's text fore/back color and 
  27.                          cc,dd is the SYSOP's text fore/back color.
  28.  
  29.         /flow            (optional), if you are using RTS/CTS hardware flow 
  30.                          control specify the /flow pararmeter, affects file 
  31.                          transfers.
  32.  
  33.         /host:xxxxxxxx   (optional), changes the Sysop to xxxxxxxx in the chat
  34.                          window, if the name has spaces in it enclose it in 
  35.                          quotes like so; "/host:Almighty Sysop".
  36.  
  37.         /TWIT            (optional), Only allow a NON-VIP user to page 1 time per day.
  38.                           
  39.  
  40. To run SYSCHAT as a replacement for the internal paging, you must run it from
  41. your PAGE.BAT file.  If this file is present TriBBS 10.0 will call it instead 
  42. of using the internal routines.  Your page bell MUST be turned on for TriBBS
  43. to call PAGE.BAT.  Also, for SYSCHAT to know it is being used as a paging door
  44. you MUST specify /P: parameter to setup paging hours.  Here is a couple of
  45. examples:
  46.  
  47.                  SYSCHAT cfg.cfg /P:8:00,23:00       This allows paging from
  48.                                                      8:00am till 11:00pm
  49.  
  50.                  SYSCHAT cfg.cfg /P:13:00,3:00       This allows paging from
  51.                                                      1:00pm till 3:00am
  52.  
  53. When SYSCHAT is being used as a paging door it will prompt the user for a
  54. reason for paging and play a tone over the PC's internal speaker.  SYSCHAT
  55. uses two different tones, one is for regular users, the other is for users
  56. in a file named VIP.TXT in the directory that the executable is in.  If the
  57. users name is in the VIP.TXT file he will always be allowed to page you, even
  58. if he is not paging you within the paging hours.  Also, if you do not answer
  59. the page SYSCHAT will write the time and reason for paging to a file named
  60. PAGE.LOG in the directory the executable is in.  To accept the page simply
  61. press a key and the program will enter chat mode.
  62.  
  63.  
  64. SYSCHAT can also be used as a replacement for TriBBS's internal sysop to user
  65. chat.  For it to function as a replacement for TriBBS's internal chat simply
  66. run it from the CHAT.BAT file.  Also if you are running it from the CHAT.BAT
  67. DO NOT SPECIFY THE /P: parameter, if you do it will go into page mode.  The
  68. program uses a file named SYSCHAT.ANS as the display for the chat screen if 
  69. you don't like the colors the SYSCHAT.ANS is in simply change it, but make
  70. sure the layout of the new file is the same as the original, SYSCHAT will 
  71. autodetect the colorscheme you are using.  Also you can specify different
  72. colors for the sysop and user text window by specifing the /C: command line
  73. parameter, like so:
  74.  
  75.  
  76.                SYSCHAT cfg.cfg /C:14,0,15,0       This set the users text
  77.                                                   colors to Yellow on Black
  78.                                                   and the sysops text colors to
  79.                                                   Bright White on Black
  80.  
  81. IMPORTANT: If you specify a color other than 0 for a window's text background 
  82.            make sure you edit the SYSCHAT.ANS file, because SYSCHAT doesn't
  83.            clear the sysop and user test windows when it first enters chat 
  84.            mode.
  85.  
  86.  
  87. You can also change colors on the fly from within SYSCHAT via the key
  88. combination ALT+C.  Left/Right keys edit the SYSOP's foreground color, Up/Down
  89. keys change the SYSOP's background colors.  F1/F2 change the USER's foreground
  90. colors and F3/F4 change the USER's background colors.  Within the color 
  91. toggles window are examples of what the text for the sysop and user will look
  92. like which change every time you change the colors.  SYSCHAT doesn't save the
  93. settings for the colors so if you find a color scheme you like better then the
  94. default colors, specify it through the /C: command line parameter.
  95.  
  96.  
  97. SYSCHAT is a very functional chat door, it allows the sysop several options
  98. while in chat mode.  First (and most important) to get help press the HOME
  99. or F1 key.  To exit the help screen simply press any key to clear the help
  100. text.  ALT+D drops to DOS and displays a msg to the user to let him know you
  101. have dropped to DOS.  ALT+L toggles the CHAT.LOG file, which logs the text
  102. you and the user enters.  When you turn logging ON, SYSCHAT will display a
  103. "Logging" in the upper right-hand corner of the screen to keep you in mind it
  104. is on.  The user cannot see this as it is only displayed on your machine.  To
  105. turn logging OFF simply press ALT+L again.  You toggle the logging function
  106. as many times as you want in a session, it will open and close the CHAT.LOG
  107. file accordingly.  ALT+T allows you to transfer files using TriBBS's TTPROT 
  108. protocol driver.  Only the sysop can enter information at the prompts, so
  109. be sure you know what you're uploading or downloading.  ALT+Z also allows you
  110. to transfer files, but instead of using TriBBS's TTPROT.EXE driver it calls
  111. batch files named SEND.BAT to send a file and RECEIVE.BAT to receive a file.
  112. SYSCHAT sets enviroment variables to be used in the SEND/RECEIVE batch files,
  113. so you can tell your protocol driver the filename, port number and baud rate.
  114. The enviroment variables SYSCHAT sets are named as followed:
  115.  
  116. %F% = file name
  117. %P% = com port
  118. %B% = baud rate
  119.  
  120.  
  121. ALT+H hangs up the phone. Hitting the ESCAPE key returns the user to the BBS.  
  122.  
  123.  
  124. SYSCHAT allows you to set it up so regular users can only page you 1 time per
  125. day.  You tell SYSCHAT to do this by specifing the /TWIT command line parameter
  126. SYSCHAT will then create and maintain a file named TWIT.DAT which will contain
  127. the users that have paged you.  If the user has paged you already today,
  128. whether or not you answered it, his name will be written to the TWIT.DAT file
  129. and all he will see from SYSCHAT when he pages again is "Sorry the sysop isn't
  130. availible for chat...".  SYSCHAT will automatically reset the TWIT.DAT file
  131. after midnight.  The /TWIT command line parameter does not affect VIP callers
  132. from being able to page you.
  133.  
  134.  
  135. SYSCHAT displays the current time and the number of minutes you have been
  136. chatting at the bottom of the screen so you can keep track.
  137.  
  138.  
  139.